home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / CoordToWin.3 < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tk_CoordsToWindow(3)  Tk Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_CoordsToWindow - Find window containing a point
  12.  
  13. SYNOPSIS
  14.      #include <tk.h>
  15.  
  16.      Tk_Window
  17.      Tk_CoordsToWindow(_r_o_o_t_X, _r_o_o_t_Y, _t_k_w_i_n)
  18.  
  19. ARGUMENTS
  20.      int         _r_o_o_t_X   (in)      X-coordinate (in  root  window
  21.                                    coordinates).
  22.  
  23.      int         _r_o_o_t_Y   (in)      Y-coordinate (in  root  window
  24.                                    coordinates).
  25.  
  26.      Tk_Window   _t_k_w_i_n   (in)      Token for window that  identi-
  27.                                    fies application.
  28. _________________________________________________________________
  29.  
  30.  
  31. DESCRIPTION
  32.      Tk_CoordsToWindow locates the window that contains  a  given
  33.      point.   The  point  is  specified  in root coordinates with
  34.      _r_o_o_t_X and _r_o_o_t_Y (if a virtual-root window manager is in  use  |
  35.      then  _r_o_o_t_X  and  _r_o_o_t_Y  are in the coordinate system of the  |
  36.      virtual root window).  The return value from  the  procedure
  37.      is a token for the window that contains the given point.  If
  38.      the point is not in any window, or if the containing  window
  39.      is  not  in  the  same  application  as  _t_k_w_i_n, then NULL is
  40.      returned.
  41.  
  42.      The containing window is decided using the same  rules  that
  43.      determine  which  window  contains  the  mouse cursor:  if a
  44.      parent and a child both contain the  point  then  the  child
  45.      gets  preference, and if two siblings both contain the point
  46.      then the highest one in the stacking  order  (i.e.  the  one
  47.      that's visible on the screen) gets preference.
  48.  
  49.  
  50. KEYWORDS
  51.      containing, coordinates, root window
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.